home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / mssize.z / mssize
Encoding:
Text File  |  2002-10-03  |  5.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. mmmmssssssssiiiizzzzeeee((((3333GGGG))))                                                          mmmmssssssssiiiizzzzeeee((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      mmmmssssssssiiiizzzzeeee - specifies multisample buffer configuration
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd mmmmssssssssiiiizzzzeeee((((lllloooonnnngggg ssssaaaammmmpppplllleeeessss,,,, lllloooonnnngggg zzzzssssiiiizzzzeeee,,,, lllloooonnnngggg ssssssssiiiizzzzeeee))))
  13.  
  14. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  15.      _s_a_m_p_l_e_s   is the number of samples to be stored at each framebuffer pixel
  16.                location. The default is zero.
  17.  
  18.      _z_s_i_z_e     is the number of bits per depth component desired in the
  19.                multisample buffer.
  20.  
  21.      _s_s_i_z_e     is the number of bits per stencil field desired in the
  22.                multisample buffer.
  23.  
  24. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.      By default the normal framebuffer is configured to store one sample at
  26.      each pixel location.  This sample can include one, two, or four color
  27.      buffers, a single depth value, and a stencil value.  mmmmssssssssiiiizzzzeeee allows
  28.      configuration of the normal framebuffer to store many samples at each
  29.      pixel location.  Because the samples specified by mmmmssssssssiiiizzzzeeee are distinct
  30.      from the single sample that is normally stored, the default mssize of
  31.      zero corresponds to the default single-sample configuration.
  32.  
  33.      mmmmssssssssiiiizzzzeeee takes effect when gconfig is called.  The requested sample count
  34.      and multisample buffer sizes are considered along with the other gconfig
  35.      requests, such as double buffering and RGB mode.  Multisample red, green,
  36.      blue, and alpha component sizes are made identical to those in the normal
  37.      framebuffer.
  38.  
  39.      For example, consider the following request:
  40.  
  41.           RGBmode();
  42.           doublebuffer();
  43.           mssize(4,32,1);
  44.           zbsize(0);
  45.           stensize(0);
  46.           gconfig();
  47.  
  48.  
  49.      If this request is honored, the framebuffer will be configured with 2 RGB
  50.      color buffers (front and back) and 4 separate samples each consisting of
  51.      a single RGB color, a 32-bit depth value, and a 1-bit stencil value.
  52.      Note that no depth or stencil bits are directly associated with the front
  53.      and back color buffers, because none were requested.
  54.  
  55.      Likewise, the request:
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. mmmmssssssssiiiizzzzeeee((((3333GGGG))))                                                          mmmmssssssssiiiizzzzeeee((((3333GGGG))))
  71.  
  72.  
  73.  
  74.           RGBmode();
  75.           doublebuffer();
  76.           mssize(4,32,1);
  77.           zbsize(32);
  78.           stensize(1);
  79.           gconfig();
  80.  
  81.  
  82.      if granted, results in the same multisample configuration, but includes a
  83.      regular zbuffer and a stencil buffer.
  84.  
  85.      The _s_a_m_p_l_e_s, _z_s_i_z_e and _s_s_i_z_e granted may not be exactly what was
  86.      requested.  After a call to mmmmssssssssiiiizzzzeeee and ggggccccoooonnnnffffiiiigggg call ggggeeeettttggggccccoooonnnnffffiiiigggg to
  87.      determine how the framebuffer was actually configured.
  88.  
  89.      Just as the default single sample at each framebuffer pixel is considered
  90.      to be located at the center of that pixel, the _s_a_m_p_l_e_s multisamples each
  91.      have a fixed location near the corresponding pixel center.  These
  92.      locations are chosen by the GL to provide good area sampling.
  93.  
  94. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  95.      gconfig, getgconfig, msalpha, msmask, mspattern, mssize, multisample,
  96.      RGBsize, stensize, zbsize
  97.  
  98. NNNNOOOOTTTTEEEESSSS
  99.      This routine is available only in immediate mode.
  100.  
  101.      IRIS-4D G, GT, GTX, VGX, and VGXT models, the Personal Iris, Indigo
  102.      Entry, Indy, XL, XS, XS24, XZ, Elan and Extreme systems do not support
  103.      mmmmssssssssiiiizzzzeeee.
  104.  
  105.      Although separate specifications are allowed for normal and multisample
  106.      z-buffer sizes, and for normal and multisample stencil buffer sizes,
  107.      implementations need not support differing non-zero buffer sizes.
  108.  
  109.      The IRIS-4D RealityEngine models support at least the following values
  110.      for _s_a_m_p_l_e_s:  0, 4, 8, 16 with a _z_s_i_z_e of 0, 24 or 32 and with an _s_s_i_z_e
  111.      of 0 through 8.
  112.  
  113. BBBBUUUUGGGGSSSS
  114.      On the IRIS-4D RealityEngine models the framebuffer cannot be configured
  115.      to consist of 32 Z buffer planes, or 32 depth planes in the multisample
  116.      buffer, and 8 color planes for each of the RGB color buffers
  117.      simultaneously.
  118.  
  119.      On the IRIS-4D RealityEngine models the framebuffer cannot be configured
  120.      to consist of more than 1 stencil plane in the multisample buffer, and 8
  121.      color planes for each of the RGB color buffers simultaneously.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.